home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
spitfire
/
sfpckusr.zip
/
SFPCKUSR.DOC
< prev
Wrap
Text File
|
1993-03-06
|
8KB
|
189 lines
SFPCKUSR
Version 1.4
Copyright (C) by Mike Woltz, 1992-1993
Buffalo Creek Software
INTRODUCTION
------------
SFPCKUSR is a utility written by Mike Woltz, author of SPITFIRE
Bulletin Board System. It is designed to work in the same way as
SPITFIRE's internal user packer. However, SFPCKUSR allows the
caller's data file, SFUSERS.DAT to be packed outside of SPITFIRE.
Using SFPCKUSR it is even possible to pack the user's file as a
SPITFIRE event. SFPCKUSR is written in Turbo Assembler for
maximum speed while requiring very little disk space.
DISTRIBUTION PACKAGE
--------------------
When decompressed, the distribution package, SFPCKUSR.ZIP, should
contain the following files:
SFPCKUSR.DOC - This documentation file
SFPCKUSR.EXE - SPITFIRE utility for packing SFUSERS.DAT
You are free to distribute the SFPCKUSR program as long as it remains
unmodified and no fee is charged. Sysops are free to post this and
subsequent versions of SFPCKUSR on public Bulletin Board Systems as
long as no fee is charged to obtain the file.
COMMAND LINE PARAMETER
----------------------
SFPCKUSR allows for the use of two command line parameters. The
command lines parameters are not required for usage. In the event
no command line parameter is used, the SFPCKUSR will purge only
caller who are marked for deletion. Either one or both command line
parameters can be used. These command line parameters are /SEC=x
and /OLD=x (x indicates a value). When the /SEC=x parameter is used,
then SFPCKUSR will pack all callers with a security level of x provided
such caller is allowed to be purged. When the /OLD=x parameter is used,
the SFPCKUSR will pack all callers who have not called in the last x
days provided such callers are allowed to be purged. When using the
/OLD=x parameter, the x value must be a numerical value equal to or
greater than 30 and less than or equal to 65535. An example of using
SFPCKUSR with the command line parameters might be:
SFPCKUSR /OLD=120 /SEC=5
If the caller has not called within the number of days you specify
on the command line, the caller will be packed from SFUSERS.DAT. In
the example above, any callers who have not called the BBS within
the last 120 days would be purged from SPITFIRE's caller data file.
Additionally, the above example provides that callers with a security
level of 5 would be purged from SFUSERS.DAT provided such purge is
allowed.
In the event no command line parameter is included on the command
line, SFPCKUSR will pack only those callers who have been marked for
deletion.
USAGE
-----
SFPCKUSR must be executed from the SPITFIRE home directory. This
is the directory in which SFNODE.DAT resides. If SFPCKUSR does not
find SFNODE.DAT operation will be halted, and a message will be
displayed notifying you that SFNODE.DAT could not be found.
SFPCKUSR will next read SFWHOSON.DAT in the SPITFIRE work directory.
SFPCKUSR will not allow you to pack the callers file while a caller is
on any of the available nodes. If a caller is on any of the available
nodes, SFPCKUSR will loop until all nodes are free. Once all the
available nodes are free, SFPCKUSR will then begin the process of
packing the SPITFIRE's callers data file, SFUSERS.DAT. If a caller
attempts to log on while SFPCKUSR is in the process of packing the
callers file, SFPCKUSR will notify the caller that system maintenance
is being performed. SFPCKUSR will display a message asking the caller
to call back at a later time and then log the caller off. SFPCKUSR
will display SPITFIRE's SFMAINT.BBS/CLR if found.
SFPCKUSR will either create or append to the existing SFPURGED.USR
data file a list of all callers who have been purged during its
execution. SFPURGED.USR contains the date and time of the purge
activity, the caller's name, the security level of the caller and
the city/state/province of the caller.
SFPCKUSR does NOT create any backup files.
USING SFPCKUSR AS A SPITFIRE EVENT
----------------------------------
SFPCKUSR can be used as a command from the DOS prompt or be
executed as a SPITFIRE event. To set SFPCKUSR up as an event
you simply need to follow the instructions in the SPITFIRE manual
for setting up an event. Below is an example of how the SF.BAT
might look like when executing SFPCKUSR as an event:
:EVENT_A
SFPCKUSR /OLD=x
GOTO LOOP
:EVENT_B
Above, x represents the numerical value for specifying the number
of days a caller must have called within to be exempt from the purge
process. This is an optional command line parameter and if not used,
SFPCKUSR will purge only callers which have been marked for deletion.
SFPCKUSR ON A MULTI-NODE SYSTEM
-------------------------------
SFPCKUSR is fully compatible for operation on a multi-node BBS.
It automatically handles any file locking and file sharing
required during its execution.
COPYRIGHT INFORMATION
---------------------
SPITFIRE is Copyright of Buffalo Creek Software, 1987-1992
REGISTRATION
------------
SFPCKUSR is distributed under the shareware concept. You may use
the files included within SFPCKUSR.ZIP for a trial period of thirty
days. If you continue to use these programs beyond the thirty day
trial period a $1.00 registration fee is required. Registration
should be sent to:
Buffalo Creek Software
ATTN: Mike Woltz
913 39th Street
West Des Moines, Iowa 50265
DISCLAIMER
----------
Mike Woltz and/or Buffalo Creek Software shall in no way be
held responsible for any damage incurred while operating SFPCKUSR.
All responsibility lies with the user of the software.
The documentation for SFPCKUSR is contributed by Jacque
Shipley and The Mother Board BBS. The shareware version of
SPITFIRE and other SPITFIRE utilities are available for download
from:
Buffalo Creek's BBS The Mother Board BBS
Mike Woltz, Sysop Jacque Shipley, Sysop
(515) 225-8496 (515) 986-3464
38400/19200/9600/2400/1200 Baud 19200/9600/2400/1200 Baud
SFPCKUSR Version 1.1 - August 15, 1992
--------------------------------------
SFPCKUSR was revised to test for adequate disk space before
starting the pack. In the event there is inadequate disk space
to perform the pack, then SFPCKUSR displays the 'Insufficient
disk space!' message and terminates.
SFPCKUSR Version 1.2 - January 1, 1993
--------------------------------------
SFPCKUSR was revised to fix a problem with the number of days
since the caller last called. The example of the problem is if
SFPCKUSR was ran on 01-01-93 it would purge any caller who had called
on 12-31-92.
SFPCKUSR Version 1.3 - March 3, 1993
--------------------------------------
SFPCKUSR was revised to work in conjunction with SPITFIRE v3.3.
The internal caller database pack procedure was removed from SPITFIRE
and SPITFIRE (v3.3) now shells to SFPCKUSR. Therefore, SFPCKUSR.COM
must be placed in the SPITFIRE HOME directory.
SFPCKUSR Version 1.4 - March 6, 1993
--------------------------------------
SFPCKUSR was revised to fix a small problem. The problem could exist
when SFPCKUSR was used from the SPITFIRE Sysop Menu on a node other than
node #1 and when the person who packed the caller database immediately
logged back on after logging off. Chances of this happening are EXTREMELY
rare, however, the problem was fixed.